home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 090 / dcopy10.arc / DCOPY.DOC next >
Encoding:
Text File  |  1986-03-10  |  8.8 KB  |  331 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                                   DCOPY
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.              (C) Copyright 1986 by Elfring Consulting, Inc.
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.                         Elfring Consulting, Inc.
  28.                           4N899 West Mary Drive
  29.                       St. Charles, Illinois  60174
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.     DCOPY
  74.     Command
  75.     ________________________________________________________________
  76.  
  77.     Purpose:  Copy one or more files to the specified disk and path 
  78.               based on a comparison of file dates and passed date.
  79.  
  80.     Format:   DCOPY [d:][path]filename[.ext] d:[path] [-][MM/DD/YY] [HH:MM:SS]
  81.  
  82.               Where: everything between the two braces "[" and "]"
  83.                      is optional and,
  84.  
  85.               d:        - is any valid drive specifier
  86.               path      - is any valid path name
  87.               .ext      - is any valid file name extension
  88.               -         - is the before date indicator
  89.               MM/DD/YY  - is a valid date (month, day, year)
  90.               HH:MM:SS  - is a valid time (hours, minutes, sec)
  91.  
  92.     Remarks:  This command functions in very much the same manner as 
  93.               the PC-DOS COPY command.  However, DCOPY lets you copy 
  94.               files based on the file's creation date or update time 
  95.               stamp.  There are two major differences between DCOPY 
  96.               and the PC DOS command COPY.  First, files are copied 
  97.               to the specified drive and path ONLY if each file date 
  98.               and time is greater than, or less than, the time and 
  99.               date included in the command.  Second, files can NOT be 
  100.               renamed as they are copied.
  101.  
  102.               DCOPY copies a file or group of files based on the file 
  103.               dates.  Full wild card and path support are included.  
  104.               The global characters "?" and "*" can be used in in the 
  105.               file name and extension parameters.  These global 
  106.               characters work in exactly the same way as they do with 
  107.               a COPY command.
  108.  
  109.               To use DCOPY you must specify a file name or pattern, 
  110.               and a destination drive at a minimum.  If no date or 
  111.               time is included in the command, DCOPY assumes you want 
  112.               to copy all files created or updated on the current 
  113.               day.  Thus:
  114.  
  115.               dcopy *.* a:
  116.  
  117.               copies all files created or updated after 12:00 AM on 
  118.               the current day.  This assumes the time and date set in 
  119.               your IBM PC, XT, or AT is correct.
  120.  
  121.               Making a copy of files based on a different time and 
  122.               date is just as easy.  To do this DCOPY needs to know 
  123.               the date and whether to copy files created before or 
  124.               after this date.  The minus key is used to indicate 
  125.               whether you want to copy files before the specified 
  126.               date.  You can optionally append a date and time to 
  127.  
  128.  
  129.                                     1
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.               split the copy based on a specific time and date.  Note 
  140.               that if no TIME is specified the time is assumed to be 
  141.               0:00, the previous days midnight.
  142.  
  143.               dcopy *.* b: 12/12/84
  144.  
  145.               copies all files from the default drive with the 
  146.               extension ".obj" that were created or last updated ON 
  147.               OR AFTER 12 AM on 12/12/84 to the B: drive.  The files 
  148.               copied to drive B: will have the same name and time 
  149.               stamp as they had on the default drive.
  150.  
  151.               dcopy b:work.* a: -1/2/85
  152.  
  153.               copies all files from the B: drive that have the file 
  154.               name "work" and any extension, to the A: drive PROVIDED 
  155.               that the file was last created or updated before 12 AM 
  156.               on 1/2/85.
  157.  
  158.               dcopy c:\work\*.c d:\help 2/20/86 15:00:00
  159.  
  160.               copies all files with the extension ".c" from the path 
  161.               c:\work to the path d:\help provided each file was last 
  162.               updated on or after 3:00 PM on 2/20/86.
  163.  
  164.     Problems: DCOPY can only handle directories that have less than 
  165.               2048 matching file entries.  If you hard disk has more 
  166.               than that number of entries try different file patterns 
  167.               to transfer less than 2048 files at a time.  Instead of 
  168.               *.* use *.c and *.obj.
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                     2
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.                            DISTRIBUTION NOTICE 
  206.  
  207.     This  program  is  protected by United States Copyright  law  and         
  208.     by International Treaty provisions.  You may distribute, or share 
  209.     the  "demo"  version  of this program with  anyone  provided  the 
  210.     following conditions are met:
  211.  
  212.     A  "demo" version of DCOPY is being distributed at no  charge  to 
  213.     all  who are interested in it.   To those of you unfamiliar  with 
  214.     this  approach,  it  works like this.   DCOPY is  distributed  to 
  215.     various  BBS systems and user groups.   You may copy the  program 
  216.     and  use it for no charge.   Elfring Consulting,  Inc.  does  not 
  217.     handle the actual freeware distribution of this program.
  218.  
  219.     The  BBS version of this program has been INTENTIONALLY  limited.  
  220.     First, it will only work until 9/1/86.  Second, one major feature 
  221.     has  been  left out of this "demo" version of  DCOPY.   The  real 
  222.     DCOPY  checks the amount of disk space available on the  destina-
  223.     tion  drive before each file is written.   If there is not enough 
  224.     room DCOPY will pause and let you change disks.   (The demo  ver-
  225.     sion does check the room but quits when the drive becomes full.)
  226.  
  227.     These limitations are imposed to be sure you pay for this program 
  228.     if  you  want  to use it.   Very few people seem to pay  for  the 
  229.     program otherwise.   NOTE:  that even though this version is lim-
  230.     ited it is fully functional.   Try the BBS version out.   If  the 
  231.     product does not meet your needs,  you pay nothing.   If the pro-
  232.     duct does meet your needs, and you can use it, then send us a fee 
  233.     of  $20.00.   We  will then supply you with the real  version  of 
  234.     DCOPY,  (the  missing features are enabled),  along with  printed 
  235.     documentation for that version.
  236.  
  237.     Send check or money order to:      Elfring Consulting, Inc.
  238.                                        4N899 West Mary Drive
  239.                                        St. Charles, Illinois
  240.                                        60174
  241.  
  242.     Even  if  you do not contribute,  you are encouraged to copy  and 
  243.     distribute  the BBS version of the product freely subject to  the 
  244.     following restrictions: 
  245.  
  246.     1. Do not distribute altered copies.   If you have suggestions or 
  247.        fixes  you  would like to see,  send us a  written  note.   We 
  248.        welcome all responses.
  249.  
  250.     2. This product must be distributed complete including the files: 
  251.        DCOPY.EXE, and DCOPY.DOC. 
  252.  
  253.     3. No  fee is to be charged for copying or distributing the  pro-
  254.        gram  without   an  express  WRITTEN  agreement  with  Elfring 
  255.        Consulting,  Inc.  The ONLY exception to this rule is: a small 
  256.        charge,  ($5  to $15),  may be leveled if this program is  in-
  257.        cluded  on a set of public domain disks.  This charge must  be 
  258.        reasonable and represent only copying and disk fees. 
  259.  
  260.  
  261.                                     3
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.     4. Commercial  sale of this product in any manner  is  prohibited 
  273.        without Elfring Consulting, Inc's written permission. 
  274.  
  275.     User Groups/Clubs:  Elfring Consulting's freeware products may be 
  276.     distributed by Clubs and User Groups subject to the same restric-
  277.     tions.  We  would  ask only that contributions to our  continuing 
  278.     efforts be encouraged by those performing such distribution. 
  279.  
  280.     Computer Bulletin Boards:  Elfring Consulting's freeware products  
  281.     may   be distributed by BBS's subject to  the  same  restrictions 
  282.     and contribution encouragement. 
  283.  
  284.  
  285.                                 WARRANTY
  286.  
  287.     Elfring Consulting,  Inc.  specifically disclaims all warranties, 
  288.     expressed  or  implied,  including but not  limited  to,  implied 
  289.     warranties  of merchantability and fitness for a particular  pur-
  290.     pose  with respect to defects in the disk or  documentation,  and 
  291.     the program license granted herein.  In no event shall Elfring be 
  292.     liable  for  any loss of profit or any other  commercial  damage, 
  293.     including but not limited to special,  incidental, consequential, 
  294.     or other damages.
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.                                     4
  328.  
  329.  
  330.  
  331.